home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / GRAPHICS / QUANT.ZIP / !Quantize / !Help < prev    next >
Text File  |  1997-02-17  |  6KB  |  214 lines
  1.  
  2.           !Quantize
  3.          -----------
  4.        By R - Fred - W
  5.              for
  6.        FishNet Software
  7.  
  8. ----------------------------------------------
  9.  Introduction:
  10. ----------------------------------------------
  11.  
  12. You've got a totally gorgeous 24 bit picture.
  13. You want a 256 colour or 16 colour picture.
  14.  
  15. !ChangeFSI only remaps into the standard Acorn
  16. palettes, & will only do "FSI" stippling (which
  17. doesn't compress well) or none at all.
  18.  
  19. !Quantize is the answer.
  20.  
  21. (correction: "or it will be, when it's finished")
  22.  
  23. What it does is look at a 24-bit sprite, and
  24. pick a nice palette of 256 or 16 colours to
  25. remap it into.
  26.  
  27. Then it does the remap.
  28.  
  29.  
  30.  
  31. Basically, !Quantize is intended for two purposes:-
  32.  
  33. (1) Creation of game graphics:-
  34.  which involves remapping multiple 24-bit images into
  35.  a single RiscPC 256-colour palette with colour 0 unused.
  36. (2) Creation of Webpage graphics:-
  37.  which involves making GIF graphics with as few colours
  38.  as possible with "simple" (ie, compressable) dithering.
  39.  
  40.  As with most utility programs, this is being written coz
  41. *I* want it. The fact that other people can use it is largely
  42. a "bonus".
  43.  
  44. ----------------------------------------------
  45.  How to make it work:-
  46. ----------------------------------------------
  47.  
  48.  Run it by double clicking.
  49.  Click on the icon-bar icon for the options window.
  50.  
  51.  Choose how many colours you want the output sprite/gif to have.
  52. (2,4,8,16,32,64,128,or 256. Your choice!)
  53.  
  54.  Choose the dithering type, masking type, & method.
  55.  
  56.  Drag your input 24-bit sprite file to Quantize. (any window).
  57.  
  58.  Hang around for a while. Quantize is NOT built for speed, but
  59. it does at least run as a background task rather than hogging the
  60. machine.
  61.  
  62.  (Adjust-clicking on the icon-bar icon brings up a "log window",
  63. which lets you know how things are going)
  64.  
  65.  When the save icons come back, type in your leafname, & drag
  66. either the sprite or the GIF to where you want it.
  67.  
  68. --------------------------
  69.  The "To be done" list:-
  70. --------------------------
  71.  
  72. Input & Output:-
  73. ----------------
  74.  * Currently 24-bit sprites only. It WILL handle
  75.   256-colour (& less) input eventually!
  76.  
  77.  * Currently only converts the 1st sprite in a file.
  78.   There will be stuff for multi-file & multi-sprite-per-file input
  79.   & output.
  80.    Possbily including animating Gifs.
  81.    Definitely including best-fit palette for multiple images.
  82.  
  83.  * Better Mask handling
  84.   -& map mask to specific colour
  85.   -& map "mask COLOUR" to a specific colour for non-masked sprites
  86.    GIF, transparent GIF, & Interlaced GIF stuff
  87.  
  88.  * Better RiscOs load/save
  89.   -Currently supports "load"/"save" from filer,
  90.    & save-to-app via <Wimp$Scrap>
  91.   -load-from-app via <Wimp$Scrap>, and ram-transfer are yet to be
  92.    implemented
  93.  
  94.  Palettes:-
  95. ------------
  96.  
  97.  * Note that it chooses full 24-bit palette entries, ie - the
  98.  output sprites'll look pretty naff in a 256-colour mode in
  99.  any case. Restriction to "Acorn 256-colour" colours may be added,
  100.  but I'm not viewing it as a priority.
  101.  
  102.  * &I'm not 100% happy with the palette choice mechanism, either!
  103.   (it fails BADLY if the piccy's got one important colour that's
  104.   miles away from everything else - eg: cartoon with thin black
  105.   lines)
  106.    Of the two methods supplied (so far), "median" generally works best
  107.   for generating 256-colour sprs from 24-bit, & "maxdist" generally
  108.   chooses better colour sets for 16/32 colour output.
  109.  
  110.  * There WILL be facilities to specify bits of palette yourself, by
  111.   "picking" them from the source sprite, or from a colour-picker
  112.   dialogue. 
  113.  
  114.  * Definable (& load/savable) palettes with:-
  115.   "Do not use" colours. (eg game "colour cycling" colours)
  116.   "Use but don't change" colours. (eg, game "used on every level" colours)
  117.  
  118.  Dithering:-
  119. -------------
  120.  
  121. * There's room for improvement in the dithering algorithm used.
  122. * FSI dithering will be added as an option.
  123.  
  124.  
  125. ----------------------------------------------
  126.  Other FishNet product:
  127. ----------------------------------------------
  128. ...available from a PD library near you...
  129. (Or from the FishNet web site - address below)
  130.  
  131. PUSHY - The box-pushing puzzle game. (Datafile Cat24,GA059,CD3)
  132. FIRE  - The big yellow wobbly thing in the fireplace,
  133.         presented as a (Risc-PC only) demo. (Datafile PDCD3)
  134. PUSHY II - More box pushing, in 24-bit Hi-Res (Datafile GA059, Cat 32)
  135. TYDIRIUM - The Risc-OS desktop game-map editing tool.
  136.  
  137. ----------------------------------------------
  138.  Coming soon:
  139. ----------------------------------------------
  140.  
  141. QUANTIZE - you're looking at a (very) early version.
  142. PUSHY II.V - The StrongArm compatable version with P1 & extra levels
  143.  (Actually, the "extra levels" version is looking increasingly unlikely.
  144.  Pushy V2.11 is SA compatable, includes Pushy 1, & is currently available)
  145. TYDIRIUM - the "finished" version ;)
  146.  
  147. ----------------------------------------------
  148.  Boring Legal Stuff:
  149. ----------------------------------------------
  150.  
  151. This program is FREEWARE
  152.  
  153. By which I mean...
  154. Anyone can take a copy of it.
  155. Anyone can give it to anyone else.
  156.  
  157. *** And you are encouraged to do so! ***
  158.  
  159. (****** NOT YET!!!! It ain't finished!!! ********)
  160.  
  161. They can even charge for the disk and the postage!
  162. But I retain the copyright, ok?
  163.  
  164.              ---
  165.  
  166. If you mod the code, even just the !Run...
  167.  
  168. (a) Make a note here so's anyone who gets a copy from
  169. then on knows about it.
  170. (b) Let me know, so future versions (and future products) can
  171. work without needing to be modded.
  172.  
  173. This software is provided 'as is'. Using it is entirely at
  174. your own risk. If asked, I will deny ever having written
  175. this software. Etc, Etc.
  176. You must know the PD legal gubbins by now...
  177.  
  178. Don't go changing things and try to pass it off as your
  179. own work. It's not big, or indeed clever.
  180.  
  181.              ---
  182.  
  183.  Extra bit of legal gubbins necessary for this program to satisfy the
  184. terms of Compuserve's royalty-free GIF license:-
  185.  
  186.  The Graphics Interchange Format(c) is the Copyright property of
  187.  CompuServe Incorporated. GIF(sm) is a Service Mark property of
  188.  CompuServe Incorporated.
  189.  
  190. ----------------------------------------------
  191.  And Finally:
  192. ----------------------------------------------
  193.  
  194. In case of...
  195.  
  196. Bugs,
  197. Problems getting it to work on your system,
  198. Praise,
  199. Objective criticism,
  200. Suitcases of banknotes,
  201. Or just plain curiosity.
  202.  
  203. email:   rfredw@argonet.co.uk
  204. WWW:     http://www.argonet.co.uk/users/rfredw/
  205.  
  206. or write to...
  207.  
  208. R Williams,
  209. 16, Bradwell Lane,
  210. Cannock Wood,
  211. Nr Rugeley,
  212. Staffs
  213. WS15 4RW
  214.